home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_curl.idb / usr / freeware / catman / p_man / cat3 / curl_easy_duphandle.Z / curl_easy_duphandle
Text File  |  2002-07-08  |  2KB  |  49 lines
  1. curl_easy_duphandle(3)      libcurl Manual   curl_easy_duphandle(3)
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        curl_easy_duphandle - Clone a libcurl session handle
  7.  
  8. SSYYNNOOPPSSIISS
  9.        ##iinncclluuddee    <<ccuurrll//ccuurrll..hh>>
  10.  
  11.        CCUURRLL **ccuurrll__eeaassyy__dduupphhaannddllee((CCUURRLL **_h_a_n_d_l_e));;
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        This  function will return a new    curl handle, a duplicate,
  15.        using all the options previously    set  in     the  input  curl
  16.        _h_a_n_d_l_e.    Both  handles  can  subsequently be used indepen
  17.        dently    and   they    must    both    be    freed    with
  18.        _c_u_r_l___e_a_s_y___c_l_e_a_n_u_p_(_).
  19.  
  20.        All  strings  that the input handle has been told to point
  21.        to  (as    opposed     to  copy)   with   previous   calls   to
  22.        _c_u_r_l___e_a_s_y___s_e_t_o_p_t     using    char * inputs, will be pointed to
  23.        by the new handle as well. You must therefore make sure to
  24.        keep  the data around until both    handles    have been cleaned
  25.        up.
  26.  
  27.        The new handle will nnoott inherit any state information,  no
  28.        connections, no SSL sessions and    no cookies.
  29.  
  30.        NNoottee  that  even    in multi-threaded programs, this function
  31.        must be called in a synchronous way, the    input handle  may
  32.        not be in use when cloned.
  33.  
  34.        This function was added in libcurl 7.9.
  35.  
  36. RREETTUURRNN VVAALLUUEE
  37.        If this function    returns    NULL, something    went wrong and no
  38.        valid handle was    returned.
  39.  
  40. SSEEEE AALLSSOO
  41.        ccuurrll__eeaassyy__iinniitt(3),ccuurrll__eeaassyy__cclleeaannuupp(3),ccuurrll__gglloobbaall__iinniitt(3)
  42.  
  43. BBUUGGSS
  44.        Surely there are    some, you tell me!
  45.  
  46.  
  47.  
  48. libcurl    7.9        18 September 2001  curl_easy_duphandle(3)
  49.